CREATE ACTIVE STANDBY PAIR
この文では、アクティブ・スタンバイ・ペアを作成します。アクティブ・マスター・データ・ストア、スタンバイ・マスター・データ・ストアが含まれます。また、1つ以上の読取り専用サブスクライバが含まれる場合もあります。アクティブ・マスター・データ・ストアは、更新をスタンバイ・マスター・データ・ストアにレプリケートし、更新をサブスクライバに伝播します。
アクセス制御
TimesTenインスタンスでアクセス制御が有効な場合、この文にはADMIN権限が必要です。
SQL構文
CREATE ACTIVE STANDBY PAIR
FullStoreName, FullStoreName [ReturnServiceAttribute]
[SUBSCRIBER FullStoreName [,...]]
[STORE FullStoreName [StoreAttributes [,...]]]
[{ INCLUDE | EXCLUDE }{TABLE | SEQUENCE | CACHE GROUP } [Owner.]{TableName | SequenceName | CacheGroupName} [,...]]
ReturnServiceAttributeの構文は、次のとおりです。
{ RETURN RECEIPT [BY REQUEST] |
RETURN TWOSAFE [BY REQUEST] |
NO RETURN }
StoreAttributesの構文は、次のとおりです。
[ DISABLE RETURN {SUBSCRIBER | ALL} NumFailures ]
[ RETURN SERVICES {ON | OFF} WHEN [REPLICATION] STOPPED ]
[ DURABLE COMMIT {ON | OFF}]
[ RESUME RETURN MilliSeconds ]
[ LOCAL COMMIT ACTION {NO ACTION | COMMIT} ]
[ RETURN WAIT TIME Seconds ]
[ COMPRESS TRAFFIC {ON | OFF}
[ PORT PortNumber ]
[ TIMEOUT Seconds ]
[ FAILTHRESHOLD Value ]
パラメータ
CREATE ACTIVE STANDBYには、次のパラメータがあります。
FullStoreName | 次のいずれかとして指定されるデータ・ストアです。 たとえば、データ・ストアのパスがdirectory/subdirectory/data.ds0 の場合、data が使用対象のデータ・ストア名です。 この名前は、DSNの記述のDataStore属性で指定されるデータ・ストア・ファイル名で、次の書式でホストIDをオプションで指定できます。
DataStoreName [ON Host]
HostにはIPアドレスまたは1つ以上のIPアドレスに割り当てられたリテラルのホスト名を指定できます。ホスト名に特殊文字が含まれている場合、"MyHost-500"のように二重引用符で囲む必要があります。(『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のホストIPアドレスの構成に関する項を参照してください。) |
RETURN RECEIPT [BY REQUEST] | RETURN RECEIPTサービスを有効にします。これによって、マスター・データ・ストアに対してトランザクションをコミットするアプリケーションは、すべてのサブスクライバがトランザクションを受信するまでブロックされます。 RETURN RECEIPTにより、すべてのトランザクションにサービスが適用されます。RETURN RECEIPT BY REQUESTを指定した場合は、ttRepSyncSet() プロシージャを使用して、選択したトランザクションに対してRETURN RECEIPTサービスを有効にできます。RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。 |
RETURN TWOSAFE [BY REQUEST] | RETURN TWOSAFEサービスを有効にします。これによって、マスター・データ・ストアに対してトランザクションをコミットするアプリケーションは、すべてのサブスクライバがトランザクションをコミットするまでブロックされます。 RETURN TWOSAFEにより、すべてのトランザクションにサービスが適用されます。RETURN TWOSAFE BY REQUESTを指定した場合は、ttRepSyncSetプロシージャを使用して、選択したトランザクションに対してRETURN RECIPTサービスを有効にできます。RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。 |
NO RETURN | RETURNサービスを使用しないように指定します。この設定がデフォルトです。 RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。 |
SUBSCRIBER FullStoreName | マスター・データ・ストアから更新を受け取るデータ・ストアです。FullStoreName は、DSNの記述のDataStore属性で指定されるデータ・ストア・ファイル名です。 |
STORE FullStoreName [StoreAttributes [,...]] | 指定されたデータ・ストアの属性を定義します。データ・ストア属性には、PORT、TIMEOUTおよびFAILTHRESHOLDが含まれています。FullStoreNameは、DSNの記述のDataStore属性で指定されるデータ・ストア・ファイル名です。 |
{ INCLUDE | EXCLUDE } {TABLE | CACHE GROUP } [Owner.]{TableName | SequenceName | CacheGroupName} [,...] | 指定された表、順序またはキャッシュ・グループをレプリケーションに含めるか、またはレプリケーションから除外します。 INCLUDEを指定すると、表、順序またはキャッシュ・グループがレプリケーションに追加されます。各オブジェクト型(表、順序またはキャッシュ・グループ)に対して1つのINCLUDE句を使用します。 EXCLUDEを指定すると、表、順序またはキャッシュ・グループがレプリケーションから除外されます。各オブジェクト型(表、順序またはキャッシュ・グループ)に対して1つのEXCLUDE句を使用します。 [Owner.]{TableName | SequenceName | CacheGroupName} [,...]は、データ・ストアに追加するか、またはデータ・ストアから削除する表、順序またはキャッシュ・グループの名前のリストです。オプションで所有者も指定できます。 |
DISABLE RETURN {SUBSCRIBER | ALL} NumFailures | NumFailuresで指定されているタイムアウト回数を経過した後、RETURNサービスのブロッキングを無効にするようにRETURNサービス障害ポリシーを設定します。SUBSCRIBERを選択すると、指定されているタイムアウト時間内にレプリケートされた更新の確認に失敗したサブスクライバのみにこのポリシーが適用されます。ALLを選択すると、いずれかのサブスクライバから応答がなかった場合、すべてのサブスクライバにこのポリシーが適用されます。この障害ポリシーは、RETURN RECEIPTまたはRETURN TWOSAFEサービスのいずれかで指定できます。 詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスのタイムアウト・エラーおよびレプリケーション状態の変更の管理に関する項を参照してください。 |
DURABLE COMMIT {ON | OFF} | DISABLE RETURNによりRETURNサービスのブロッキングが無効になった場合、データ・ストアのDurableCommits設定を上書きし、永続コミットを有効にします。 |
FAILTHRESHOLD Value | ディスク・ベースのロギングの場合、Valueには、サブスクライバ・データ・ストアのために累積できるログ・ファイルの数を指定します。この値を超えると、サブスクライバはFailedの状態に設定されます。 値0は、制限がないことを示します。この値がデフォルトです。 詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のレプリケートされたデータ・ストアのログの管理に関する項を参照してください。 |
LOCAL COMMIT ACTION {NO ACTION | COMMIT} | タイムアウト・イベントのRETURN TWOSAFEトランザクションで実行されるデフォルトのアクションを指定します。
注意: | この属性は、RETURN TWOSAFEまたはRETURN TWOSAFE BY REQUEST属性がSUBSCRIBER句で設定されている場合にのみ有効です。 |
NO ACTION: タイムアウト時、コミット関数がアプリケーションに戻り、トランザクションはコミット・コールに入ったときと同じ状態のままになります。ただし、アプリケーションがレプリケートされた表を更新できない場合を除きます。アプリケーションはコミットの再発行またはコールのロールバックを実行できます。 COMMIT: タイムアウト時に、コミット関数がCOMMITをログ・レコードに書き込み、トランザクションをローカルで効率よく終了します。同じトランザクション上でこれ以上の処理を行うことはできません。 このデフォルト設定は、localAction パラメータを指定してttRepSyncSet() プロシージャをコールすることで、特定のトランザクションに対して無効にすることができます。 |
MASTER FullStoreName | アプリケーションで特定のELEMENTが更新されるデータ・ストアです。MASTERデータ・ストアによって、更新がSUBSCRIBERデータ・ストアに送信されます。FullStoreNameは、DSNの記述のDataStore属性で指定されたデータ・ストアであることが必要です。 |
NO RETURN | RETURNサービスを使用しないように指定します。この設定がデフォルトです。 RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。 |
PORT PortNumber | このデータ・ストアのレプリケーション・エージェントが接続をリスニングするTCP/IPポート番号です。指定しない場合は、レプリケーション・エージェントによってポート番号が自動的に割り当てられます。 |
PROPAGATOR FullStoreName | レプリケートされた更新を受け取り、他のデータ・ストアに渡すデータ・ストアです。FullStoreNameは、DSNの記述のDataStore属性で指定されたデータ・ストアであることが必要です。 |
説明
- CREATE ACTIVE STANDBY PAIRの直後には、2つのマスター・データ・ストア名が続きます。マスター・データ・ストアは、後でttRepStateSetプロシージャを使用してACTIVEおよびSTANDBYとして指定します。『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のアクティブ・スタンバイ・ペアの設定に関する章を参照してください。
- SUBSCRIBER句には、1つ以上の読取り専用サブスクライバ・データ・ストアを指定します。最大62のサブスクライバ・データ・ストアを指定できます。
- アクティブ・マスター・データ・ストアとスタンバイ・マスター・データ・ストアの間のレプリケーションは、RETURN TWOSAFE、RETURN RECEIPTまたは非同期のいずれかに設定できます。RETURN TWOSAFEに設定すると、トランザクションは失われません。
- 指定された表、順序およびキャッシュ・グループをレプリケーションから除外する場合、または指定された表、順序およびキャッシュ・グループのみを含めて他は除外する場合は、INCLUDEおよびEXCLUDE句を使用します。
例5.31
この例では、マスター・データ・ストアがrep1
およびrep2
のアクティブ・スタンバイ・ペアを作成します。サブスクライバrep3
が1つあります。レプリケーションのタイプはRETURN RECEIPTです。また、この文では、PORTおよびTIMEOUT属性をマスター・データ・ストアに対して設定します。
CREATE ACTIVE STANDBY PAIR rep1, rep2 RETURN RECEIPT
SUBSCRIBER rep3
STORE rep1 PORT 21000 TIMEOUT 30
STORE rep2 PORT 22000 TIMEOUT 30;
関連項目
ALTER ACTIVE STANDBY PAIR
DROP ACTIVE STANDBY PAIR